home *** CD-ROM | disk | FTP | other *** search
/ SuperHack / SuperHack CD.bin / CODING / DELPHI / COMPRESS.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-04-02  |  8.4 KB  |  205 lines
  1.                  TCompress Component Set V2.0
  2.   File and Database Compression Components for Delphi 1.0 and 2.0
  3.  
  4.  Copyright (c) 1995, 1996  Peter Hyde, South Pacific Information Services Ltd
  5.              Fax: +64-3-384-5138  Email: peter@spis.co.nz
  6.              Web:  http://www.spis.co.nz/spis/compress.htm
  7.  
  8.          These components are fully functional SHAREWARE.
  9. >>>>> If you ordered the registered version of TCompress, see REGINFO.TXT
  10.  
  11.  
  12. You are encouraged to pass them on, upload them to BBS, Web and ftp sites
  13. and generally spread them around as much as you can -- but please keep all
  14. the files together!
  15.  
  16. If you find TCompress useful, registration will get you the latest version,
  17. a personal ID to eliminate the occasional reminder message, access to our
  18. highly regarded (and, I have to say it, rarely needed) support AND a nice warm
  19. fuzzy feeling.
  20.  
  21. Registration details are at the end of this file.
  22.  
  23.      ===== PLEASE SEE COMPRESS.HLP FOR MUCH MORE INFORMATION =====
  24.  
  25. 1. Key features:
  26.  
  27. * Support for Delphi 1.0 (16-bit) and Delphi 2.0 (32-bit)
  28. * NATIVE Delphi compression -- no mucking about with DLLs, VBXes et al
  29. * Multi-file compressed archives using the TCompress component
  30. * Database BLOB (memo, image) compression with TCDBMemo and TCDBimage
  31. * In-memory compression using streams (file/memory/blob<-->file/memory/blob)
  32. * Event hooks for customizable user interaction
  33. * Built-in RLE (Run-Length Encoding) and LZH (Lempel-Ziv-Huffman) compression
  34. * Easy to add your own custom compression routines at any time
  35. * Loads of example source included
  36. * Full component source code available
  37.  
  38.  
  39. 2. Installation:
  40.  
  41.     Quick Start (for people in a hurry):
  42.  
  43. *   Install COMPRESS.DCU and COMPCTRL.DCU into your component library
  44. *   Load the COMPDEMO project, compile and run it
  45. *   Examine COMPMAIN.PAS for numerous examples of how to use the compression
  46.     components
  47.  
  48.     Full Installation Instructions (for careful people):
  49.  
  50. *   32 bit components are in the main archive, 16 bit DCUs in COMP16.ZIP
  51.  
  52. *   BACKUP your COMPLIB.DCL file
  53.  
  54. *   Also BACKUP the Delphi's DEMOS\DATA\BIOLIFE.* files, as this database is
  55.     used by COMPDEMO to show off blob compression
  56.  
  57. *   Put COMPRESS.DCU/.DCR and COMPCTRL.DCU/.DCR in a directory on Delphi's
  58.     Component Library Search path
  59.  
  60. *   Select Install Components, then click Add and type COMPRESS. Click
  61.     Add again and type COMPCTRL. Click OK.
  62.  
  63. *   All being well, a rebuild will take place and a new Compress tab will
  64.     appear on your component palette. This contains the TCompress, TCDBMemo
  65.     (Compressed Database Memo) and TCDBImage (Compressed Database Image)
  66.     components.
  67.  
  68. *   Ensure the DBDEMOS alias is pointing to the directory containing the
  69.     BIOLIFE database (Delphi installs this, so it should be fine)
  70.  
  71. *   Load the COMPDEMO project and run it.
  72.  
  73. Note: TCompress and its companions provide very comprehensive data
  74. compression capabilities. Most developers might only need to drop
  75. TCompress on a form and call its ExpandFile/CompressFile methods in
  76. order to create and work with their own multi-file archives...
  77.  
  78. Others might drop TCDBMemo/TCDBImage components on as well and simply
  79. interact with them to have text and picture data automatically compressed
  80. when they are stored in a database.
  81.  
  82. ...and some developers might use the TCBlobfield class to store all kinds
  83. of data (sound, numbers, video etc) directly into compressed database
  84. blobs (see the BLOB.DPR demonstration for an example of this).
  85.  
  86.  
  87. 3.  Installing Help (for integrated help while running Delphi):
  88.  
  89. *   Put COMPRESS.HLP in Delphi's BIN directory
  90. *   Put COMPRESS.KWF file in into Delphi's HELP directory
  91. *   Run the HELPINST utility, and select FILE|OPEN|BIN\DELPHI.HDX.
  92. *   Click the + icon and select COMPRESS.KWF.
  93. *   Select File|Save to write the updated DELPHI.HDX file, then exit.
  94. *   You should now be able to access TCompress help from within Delphi,
  95.     e.g. by pressing F1 while the cursor is in the RegName property or
  96.     OnCheckFile event.
  97.  
  98.  
  99. 4. File list:
  100.  
  101. COMPRESS.DCU           TCompress component (Delphi 2.0 version)
  102. COMPONLY.DCU           Special version of TCompress -- doesn't require BDE!
  103. COMPRESS.DCR           Component palette icon for TCompress
  104.  
  105. COMPCTRL.DCU           TCDBImage, TCDBMemo and TCBlobField components
  106. COMPCTRL.DCR           Component palette icons for the above
  107.  
  108. COMP16.ZIP             As above, but for Delphi 1.0 (16-bit versions)
  109.  
  110. COMPRESS.HLP           Complete help file for TCompress component set
  111. COMPRESS.KWF           Keyword file to integrate into Delphi's help
  112.  
  113. COMPDEMO.DPR           TCompress demonstration project file
  114. COMPMAIN.PAS           Source for the above (many examples here!)
  115. COMPMAIN.DFM           Form for the above
  116.  
  117. BLOB.DPR               Example project for storing miscellaneous
  118. BLOBDEMO.PAS           data (e.g. arrays, sound, AVI etc) in a
  119. BLOBDEMO.DFM           compressed database blob. See comments
  120.                        at the top of BLOBDEMO.PAS.
  121.  
  122. RLECOMP.PAS            Example source showing how to implement a custom
  123.                        compression handler (for RLE in this case)
  124.  
  125. ARC2MEM.PAS            Example of expanding data directly from an
  126.                        archive to memory (drops into COMPMAIN.PAS)
  127.  
  128. ARC2BLOB.PAS           Example of copying compressed data directly
  129.                        from a file archive to a  compressed blob
  130.                        WITHOUT expanding it first (drops into COMPMAIN)
  131.  
  132. HISTORY.TXT            Development history
  133.  
  134. README.TXT             This file
  135.  
  136.  
  137. 5. Synopsis (for Web/BBS listings etc):
  138.  
  139. Filename: COMPRESS.ZIP   (File date: 2-April-96  Time: 2:00)
  140. 1 line description:
  141. TCompress v2.0 File and Database Compression Components for Delphi v1.0 and 2.0
  142. Uploader name & email: Peter Hyde, peter@spis.co.nz
  143. Surface address: SPIS Ltd PO Box 19-760, Christchurch, NEW ZEALAND
  144. Special requirements: Delphi v1.0 or v2.0
  145. Shareware payment required from private users: $NZ 70 (about $US 50)
  146. Source included: No (available separately)
  147. Size zipped / original (in Kb): 150 / 315
  148.  
  149. 10 line description:
  150.  
  151. TCompress provides native Delphi components for the creation of multi-file
  152. compressed archives, as well as database, file and in-memory compression using
  153. Delphi streams.
  154. Two compression methods (RLE and LZH) are built in, with "hooks" for the easy
  155. addition of custom compression formats.
  156.  
  157. TCompress also includes drop 'n play components for automatic database blob, 
  158. image and memo compression, based on Delphi's TDBMemo and TDBImage components.
  159.  
  160. Images compress by up to 98% when using LZH, hence there is a massive saving
  161. in disk space and disk or network access when using these components.
  162.  
  163. TCompress comes with an extensive demonstration, many source examples and 
  164. Delphi-compatible help and keyword files. Supports Delphi 1.0 and 2.0.
  165.  
  166.  
  167. 6. Registration
  168.  
  169. *** If you are are registered V1.5 user, please see the special upgrade
  170. pricing in the Registration section of COMPRESS.HLP.
  171.  
  172. Full registration information is in COMPRESS.HLP. When you register, you will
  173. receive an updated version (if any), and a personal registration ID to
  174. eliminate the occasional reminder dialog.
  175.  
  176. On registration, you can optionally also order the source code of the
  177. TCompress component (COMPRESS.DCU) and/or the TCDBImage/TCDBMemo components
  178. COMPCTRL.DCU). Please specify when ordering if you also want these.
  179.  
  180. Registration prices:
  181.  
  182. Product Registration/License:   $NZ 70 (about $US 50)
  183. Optional Compress source (add): $NZ 55 (about $US 37)
  184. Optional Compctrl source (add): $NZ 45 (about $US 30)
  185. Optional airmailed disk  (add): $NZ  5 (no charge if emailed/faxed)
  186.  
  187. Payments may be made by Mastercard or Visa (please specify card number,
  188. expiry date, and name of holder). You may also pay by a bank check in your own
  189. currency to the equivalent value at current exchange rates. We do NOT accept
  190. Compuserve SWREG registrations.
  191.  
  192. Please print or email the form in COMPRESS.HLP to register your version.
  193.  
  194. Contact: SPIS Ltd, PO Box 19-760, Christchurch, New Zealand
  195. Fax: +64-3-384-5138           Email: peter@spis.co.nz
  196.  
  197.  
  198.  
  199. *** For late-breaking information, new versions, new components, tips and tricks,
  200.     visit our Web page at
  201.     http://www.spis.co.nz/spis/compress.htm
  202.  or http://super.sonic.net/ann/delphi/more/tcompres/
  203.  
  204. (*) Keep an eye out there for news of TSegCompress for multi-disk archives, and a TCompress OCX.
  205.